Sprinklr

Sprinklris a customer service platform that lets you connect with your customers through chatbots, live chat, and broadcasts on various channels. You can integrate DRUID bots with Sprinklr to handle user requests within various channels.

Prerequisites

  • You need to have a Sprinklr Developer account (using a service account email) to register the application that will be linked to your DRUID bot.
  • You need a Client user account on the Sprinklr platform with access to your company's Sprinklr environment.

This section describes how to integrate DRUID chatbots with Sprinklr.

Step 1. Get the Sprinklr platform environment and Campaign ID

  1. Sign in to the Sprinkler Platform.
  2. Right click anywhere on the homepage and select View Page Source.
  3. Press Ctrl+F and search for "sentry-environment". The value of sentry-environment is where your Sprinklr instance is hosted. This is your Sprinkler environment.

  4. Copy the environment name you will need it to create a Sprinkler app.
  5. Close the Page source code page.
  6. Type "Campaigns" in the search bar and select the desired item from the search results.

  7. The list of defined campaigns appears. Campaigns are used in Sprinklr as the primary tags to categorize outbound messages and thereby effectively organize and collaborate on activities around the campaign such as tasks, assets, messages, workflows, etc.
  8. Copy the ID of the approved campaign as you will need it to configure the Sprinklr channel in the DRUID Portal.

You can now create a Sprinklr app.

Step 2. Create a Sprinklr app

  1. Sign into Sprinklr Developer Portal.
  2. Click on your email address appearing at the top right corner and select Apps from the drop-down menu.

  3. Click on the + NEW APP button to create a new application.
  4. In the application form, fill in the required fields:
    5. Field Description
    App Name The name of the application. It is recommended to name your application based on the use case you will be using it for.
    APIs

    Enable the API for your Sprinklr platform environment, the one you copied at Step 1.
  5. In the Callback URL field, enter https://www.sprinklr.com.
  6. Click the Save button at the bottom of the page to save the app. An API Key and Secret are generated for the app.
  7. Copy the API Key and Secret as you will need them to configure the Sprinklr channel in the DRUID Portal.

  8. Reach out to Sprinklr support to activate your app.
Important!  Although the app status shows as Active in the Sprinklr Developer Portal, it is not actually active in your specific environment. To activate the app, you must contact Sprinklr Support and request activation for your environment.

Now configure the Sprinklr channel in the DRUID Portal.

Step 3. Configure the Sprinklr channel in DRUID

  1. Log in the DRUID Portal and from the main menu, select your bot. The bot configuration page appears by default on the Details tab.
  2. Click the Channels tab, and then click Sprinklr. The channel info section expands.
  3. Fill in the fields as follows:
    4. Field Description
    Environment The name of the environment you copied at Step 1, substep 4.
    Campaign ID The ID of the campaign you copied at Step 1, substep 8. The bot messages will be sent to this campaign.
    ApiHost

    The Sprinklr API URL. It is in the format: https://api<version>.sprinklr.com. For example: https://api3.sprinklr.com.

    You can get it from the Sprinklr documentation.
    API key The API Key and Secret you copied at Step 2, substep 7.
    API secret
  4. Generate the Webhook Secret.
  5. Copy the Webhook inbound URL and the Webhook Secret as you will need them to configure the Sprinkler webhook.
  6. Click the Publish button and wait until the channel is activated.

Step 4. Create Sprinklr webhook

  1. Sign in to the Sprinkler Platform.
  2. Type "webhook" in the search bar and select the item from the search results.

    3. From the main menu, click API 2.0 and on the page, click Webhooks.

  3. Click the Add Webhook button at the top-right corner of the page.
  4. In the webhook configuration page, enter the following details:
    5. Field Description
    Name Enter a webhook name.
    Authentication Type Select Pre-Shared Key.
    Pre-Shared Key Enter the Webhook Secret you copied from the DRUID Portal at Step 3, substep 5.
    Callback URL

    Enter the Webhook inbound URL you copied from the DRUID Portal at Step 3, substep 5.

    Click the Verify Webhook button available in this field.
    Subscription

    Add the following subcriptions:

    • Message Received
    • Message Association Change
    • Case Updated

  5. Save the webhook.

You have successfully completed the Sprinklr channel configuration.